home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / conct305.zip / CONCAT.DOC < prev    next >
Text File  |  1993-05-15  |  6KB  |  133 lines
  1. CONCAT.DOC
  2. 05/15/93
  3.  
  4. Program written by:
  5.                         Bruce Guthrie
  6.                         Room H-4885
  7.                         U.S. Dept of Commerce/ESA/OBA/BSISD
  8.                         Washington, D.C. 20230
  9.  
  10.                         (202) 482-3234
  11.  
  12. You may freely copy and re-distribute this program; however, the U.S.
  13. Department of Commerce neither guarantees nor assures compatibility of the
  14. program with all computer software or hardware.
  15.  
  16.  
  17. The CONCAT.EXE program is designed to make concatenating data sets together
  18. easier.  The routine creates a single output file from one or more input files;
  19. it is a file concatenator instead of a file copier.
  20.  
  21. It also allows you to create fixed-length records for uploading to mainframe on
  22. tape.
  23.  
  24.  
  25. CONCAT supports a number of neat concatenation features:
  26.  
  27. * It allows you to copy multiple data sets together as a single file.  DOS's
  28. COPY command can do this as well.
  29.  
  30. * It allows you to store the files to be copied in an external file.  This
  31. insures that the files are copied in the desired order without requiring you to
  32. create lots of intermediate data sets.
  33.  
  34. * It allows you to copy datasets from multiple floppy diskettes.  After it's
  35. copied the desired file(s) from the diskette, it allows you to change the
  36. diskette and resume copying from the new diskette.
  37.  
  38. * It handles SPLTFILE-created files (MYFILE.001 MYFILE.002 etc) from multiple
  39. diskettes without having to copy them to your hard disk before concatenating
  40. them.
  41.  
  42. * In TEXT mode, it allows you to specify that the end of each file is to have
  43. a carriage return/line feed added to it.  This makes sure that each new file
  44. starts at the start of a line.
  45.  
  46.  
  47.  
  48. Invoking the program:
  49.  
  50. The program can be invoked with the following options:
  51.  
  52.     CONCAT [ filespec | @filespec | [drive:]filespec+ ] outfile
  53.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  54.       [ BINARY | /TEXT [ /CRLF ] ] [ /LRECL=nnn [ /BLKSIZE=nnnn ] ]
  55.       [ /NAMED ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  56.  
  57. where:
  58.  
  59. "filespec" says to concatenate any file(s) with the specified filespec.  For
  60. example, "CONCAT *.PUB NEWFILE.TXT".  The filespec can include a drive and
  61. path designation if desired.
  62.  
  63. "@filespec" says the files to copy are contained in an external file called
  64. "filespec".  The routine will read this file one line at a time and process the
  65. requests sequentially.  Any record which is blank or begins with a semi-colon is
  66. ignored.  Otherwise, the record is presumed to be a valid filespec (with
  67. wildcards if desired). The filespec can include a drive and path designation if
  68. desired.
  69.  
  70. "filespec+" says to start with "filespec" (which presumably has an extension of
  71. ".001") and then grab .002, .003 etc.  For example, "CONCAT A:MYFILE.001+
  72. NEWFILE.ZIP".  As with the other filespec inputs, the filespec can include a
  73. drive and path designation if desired.  In most cases, you'll be using the
  74. incrementation feature with a floppy drive like "A:" which is why the drive
  75. designation is specifically shown here.
  76.  
  77. "outfile" is the name of the output file to create.  The filespec can include a
  78. drive and path designation if desired.
  79.  
  80. "/OVERWRITE" says to write over any output file that's already there.
  81.  
  82. "/APPEND" says to add the new records at the end of any output file that's
  83. already there.
  84.  
  85. "/-OVERWRITE" says to abort if the output file exists already.
  86.  
  87. "/OVERASK" says to prompt if the output file exists already; this is the
  88. default.
  89.  
  90. "/BINARY" says to copy the file in BINARY mode.  This means that the entire file
  91. will be copied based on its designated DOS size designation.  If you copy a text
  92. file with this option, you'll typically have end-of-file (Ctrl-Z) markers within
  93. your text.  These make the file unreadable in many text editors.  BINARY is
  94. required for any binary file; ZIP, COM, EXE, etc.  The default mode is "/TEXT".
  95.  
  96. "/TEXT" says to copy the file in TEXT mode.  The file is copied until the
  97. program reaches an end-of-file (Ctrl-Z) marker and then it stops copying that
  98. file.  TEXT mode is desirable for straight ASCII text documents but it can't be
  99. used with binary files which might contain a Ctrl-Z in them.  The default mode
  100. is "/TEXT".
  101.  
  102.  
  103. "/CRLF" makes sure that a carriage return/line feed character is written at the
  104. end of each concatenated file.  This insures that each new file will start at
  105. the beginning of a line.
  106.  
  107. "/LRECL=nnn" allows you to say you want to copy the file in TEXT mode (which is
  108. presumed) and you want each record padded to a length of "nnn" characters.  So
  109. "CONCAT VARIABLE.TXT FIXED.TXT /LRECL=100" will take each record in the file
  110. VARIABLE.TXT and pad each record to be 100 characters in length.  Specifying an
  111. LRECL is done for files that have to be copied for a mainframe computer.  When
  112. padding is done, lines do not end with a carriage return/line feed.
  113.  
  114. "/BLKSIZE=nnnn" is mainly an informational parameter.  The routine checks to
  115. make sure your specified BLKSIZE is an even multiple of your LRECL.  If no
  116. BLKSIZE parameter is specified, the routine will tell you what the blocksize
  117. should be; giving you the highest blocksize under the CD Publisher's default
  118. blocksize of 8192 bytes.
  119.  
  120. "/NAMED" adds a couple of lines within the concatenated file telling you the
  121. name of the original file.  These lines show up before each block from the
  122. original file in a manner similar to that seen with DOS' FIND command.
  123.  
  124. "/BEEP" gives you a beep when the program finishes.
  125.  
  126. "/-BEEP" reverses /BEEP and is the default.
  127.  
  128. "/Q" says to go into Quiet mode.  You will not get the normal block-by-block
  129. play that normally shows up.
  130.  
  131. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  132.  
  133.